home *** CD-ROM | disk | FTP | other *** search
/ The Original Shareware 1.1 / The Original Shareware (WeMake CDs)(Volume 1.1)(CDs, Inc)(1993).iso / 7 / zcomd289.zip / ZCOMMDOC.AC < prev    next >
Text File  |  1989-02-23  |  75KB  |  1,801 lines
  1.  
  2.         Version 17.32 TurboDial 2.33            Universal Line Printer Edition
  3.         ZCOMM User Manual                                                   61
  4.  
  5.  
  6.         13.  MESSAGE TRANSFERS
  7.  
  8.         13.1  Downloading Messages
  9.  
  10.         ZCOMM is flexible capturing output from other systems.  The trick is
  11.         to make the remote send the information without too much
  12.         embellishment.
  13.  
  14.         When downloading files without a file transfer protocol, set the
  15.         timesharing system to send tabs as tab characters without expanding
  16.         them to spaces.  Turn off fill characters.  These extra characters
  17.         waste time and money and ZCOMM doesn't need them.  ZCOMM's s and S
  18.         modes can be used to strip control characters and escape sequences
  19.         from the capture download.
  20.  
  21.         EXAMPLE: t -s file
  22.  
  23.  
  24.         If the remote system responds to XOFF and XON, E mode (Error
  25.         Containment(TM)) may be used to minimize information loss caused by
  26.         line hits.  The E mode may be enabled to allow Error Containment(TM)
  27.         to reduce the number of characters garbled by "line hits".
  28.  
  29.         EXAMPLE: t -E7e file1 uses Error Containment to download file1 from a
  30.         system using 7 bits even parity.  Error Containment works best when
  31.         even or odd parity is available.
  32.  
  33.  
  34.         SEE ALSO: E, j, S, s modes
  35.  
  36.         13.1.1  XON/XOFF  Files of arbitrary length may be transferred if the
  37.         remote supports flow control with the ASCII XOFF and XON control
  38.         characters.  Output from most timesharing services may be captured to
  39.         a file using this method.
  40.  
  41.         To download a file with XON/XOFF flow control: t file1
  42.  
  43.  
  44.         13.1.2  DC2/DC4 (^R/^T)  Some bulletin boards support file downloads
  45.         by issuing a DC2 to open a capture buffer, sending the file, and
  46.         terminating the capture with DC4.  ZCOMM does not support this
  47.         "protocol" directly.  The review t and b commands can be used to strip
  48.         excess characters from the circular buffer before writing the file to
  49.         disk.
  50.  
  51.         This "protocol" can be implemented with Turbodial(TM) script commands:
  52.  
  53.         EXAMPLE:      pat 1c "\022" "@kill; create capture.fil"
  54.              pat 2c "\024" "close"
  55.  
  56.  
  57.  
  58.  
  59.         (C) 1988 Omen Tech Inc                    Chapter 13 Message Transfers
  60.  
  61.  
  62.         Version 17.32 TurboDial 2.33            Universal Line Printer Edition
  63.         ZCOMM User Manual                                                   62
  64.  
  65.  
  66.         13.1.3  Data Dump  Sometimes no flow control is available.  The fget *
  67.         command allows ZCOMM to accept a continuous stream of data at a
  68.         maximum data rate determined by the hardware and software environment.
  69.         With a hard disk, excellent results have been obtained with a 4.77 mHz
  70.         PC accepting graphics dumps at 9600 bps.
  71.  
  72.         EXAMPLE: fget file1
  73.  
  74.  
  75.         At slower speeds or with a fast computer, the term function j mode*
  76.         may be used for nonstop file capture.
  77.  
  78.         EXAMPLE: t -j file1
  79.  
  80.  
  81.         The fget command does not provide a progress display.  While this
  82.         allows the fastest possible data capture (38kb on a suitable
  83.         computer), sometimes there is no handy way to monitor the flow of
  84.         data.  The term function I (super-image) mode may be used to capture a
  85.         binary file, provided CRT emulation is disabled with a display dumb
  86.         command or enabling v mode.
  87.  
  88.         EXAMPLE: display dumb; t -Ij file1
  89.  
  90.         The fax directory entry in PHONES2.T gives another example of how
  91.         ZCOMM's data capture modes may be used to capture binary data.
  92.  
  93.         13.2  Uploading Messages
  94.  
  95.         It is often possible to upload files using the f command with one or
  96.         more modes (such as w or p, possibly in combination with t).
  97.  
  98.         Message uploads are more reliable if you set enab flow when connecting
  99.         through Telenet.  If using Tymnet, type ^R^X just before the host
  100.         computer name to enable flow control with XOFF and XON.  Check with
  101.         your network's documentation for further details or updates to this
  102.         information.
  103.  
  104.         It often helps to use "half duplex" ( h mode) with the computer echo
  105.         disabled when uploading files to the computer.  This saves the
  106.         computer from wasting precious time echoing characters.
  107.  
  108.         Another tactic is to avoid uncorrected message transfers during peak
  109.         hours.  Telephone usage peaks during midday with a resulting increase
  110.         in noise induced line hits.  Timesharing computers and communications
  111.         networks are more likely to drop characters due to buffer overloading
  112.         during high traffic periods as well.
  113.  
  114.         13.2.1  Paced  Some systems accept characters only at a certain rates,
  115.         a slow speed for each character and a possible slower speed at the end
  116.         of each line.  Depending on the particular system, data transfer may
  117.  
  118.  
  119.         (C) 1988 Omen Tech Inc                    Chapter 13 Message Transfers
  120.  
  121.  
  122.         Version 17.32 TurboDial 2.33            Universal Line Printer Edition
  123.         ZCOMM User Manual                                                   63
  124.  
  125.  
  126.         have to pause briefly at the end of the line,[1] or wait for a
  127.         particular character to signify readiness to accept the next line.
  128.         There may be an additional delay after that[2] before the remote is
  129.         able to accept more data.
  130.  
  131.         EXAMPLE: f -p file1 uploads file1 with a wait for the linefeed echo at
  132.         the end of each transmitted line.
  133.  
  134.  
  135.         EXAMPLE: pg63; f -p file1 Sets the prompt character to decimal 63
  136.         ("?") and sends the file with a wait for "?" after each transmitted
  137.         line.
  138.  
  139.         As with the fpute command, the remote system must be commanded to open
  140.         and close the file.
  141.  
  142.         13.2.2  Throttle  Another method of slowing message uploads is the
  143.         throttle, activated by t mode.  Throttle artificially slows Zcomm's
  144.         character transmission to allow more time for the receiving system to
  145.         digest each character. The speed of transmission with t mode is
  146.         controlled by the t numeric parameter.
  147.  
  148.         EXAMPLE: f -t secret.msg
  149.  
  150.         Really slow systems may require both throttle and pacing to send data
  151.         efficiently without loss.
  152.  
  153.         EXAMPLE: f -tp turkey.slo
  154.  
  155.  
  156.         13.2.3  Uploading to IBM Mainframes  Text files can be uploaded to IBM
  157.         mainframes using the P (upper case) mode.  When the P mode is
  158.         activated, ZCOMM will wait for an XON (^Q) after sending each line.
  159.         In this special mode, ZCOMM will not time out waiting for the XON, no
  160.         matter how long it takes for the IBM front end to send it.  If, for
  161.         some reason, the front end fails to send the XON, (or if it is garbled
  162.         in transmission), Ctrl-Q may be keyboarded.
  163.  
  164.         EXAMPLE: f -P file1
  165.  
  166.  
  167.         SEE ALSO: P mode, Kermit protocol
  168.  
  169.  
  170.  
  171.         __________
  172.  
  173.          1. Controlled by the p numeric parameter
  174.  
  175.          2. Controlled by the q numeric parameter
  176.  
  177.  
  178.  
  179.         (C) 1988 Omen Tech Inc                    Chapter 13 Message Transfers
  180.  
  181.  
  182.         Version 17.32 TurboDial 2.33            Universal Line Printer Edition
  183.         ZCOMM User Manual                                                   64
  184.  
  185.  
  186.         13.2.4  Uploading Messages to Bulletin Boards  The greatest file
  187.         transfer challenge is to upload a file to a bulletin board message
  188.         system running on a tiny microcomputer.  Bulletin board message
  189.         systems have a rich variety of operating sequences and timing
  190.         dependencies matched only by the proliferation of incompatible
  191.         dialects of Basic and Pascal.
  192.  
  193.         Message upload from files to bulletin boards reduces connect time and
  194.         $welling of the Phone Bill.  Unattended message transfer saves the
  195.         user's time, especially if the board is difficult to access.
  196.  
  197.         The t, p and w modes and the g, p, t, and q numeric parameters allow
  198.         disk files to be uploaded to such systems.
  199.  
  200.         The basic program cbbsck.bas may be used (perhaps with modifications)
  201.         to check that a message file does not violate the restrictions of the
  202.         message system being uploaded to.  A C version is also available.
  203.  
  204.         EXAMPLE: f -pt file1
  205.  
  206.  
  207.         13.2.5  Uploading to CompuServe SIGS  A file may be uploaded to a
  208.         CompuServe SIG (Special Interest Group) editor with p mode and the g
  209.         numeric parameter set to colon.  When the file has been transferred,
  210.         hit ENTER to send a blank line to terminate message entry.
  211.  
  212.         EXAMPLE: set eolstr "\r."; pp1000; pg58; f -p FILE Is useful for
  213.         uploading a prepared message to Compuserve's bulletin boards.  This
  214.         setting for eolstr inserts a period after each line to prevent the
  215.         Compuserve software from reformatting the message.
  216.  
  217.  
  218.         EXAMPLE: pp1000, pg58, and f -p FILE transmits FILE waiting for the
  219.         prompt character ":" before sending each line after the first.
  220.  
  221.  
  222.         An alternative is to set the SIG "FIL" option, which calls the EDIT
  223.         editor.  The cisupl script file referenced by phones2.t uses the SIG
  224.         "FIL" editor option.
  225.  
  226.         Compuserve nodes often drop characters when files are uploaded at full
  227.         speed in full duplex.  This can be avoided by using h mode (local
  228.         echo) and turning off Compuserve's echo.
  229.  
  230.         13.3  Fpute
  231.  
  232.         Text files can often be uploaded reasonably efficiently using the
  233.         fpute command.* Fpute waits for an echo to each character sent to the
  234.         remote.  Fpute provides modest throughput without loss of data for
  235.         systems with terminal ports designed for keyboard data entry.  The
  236.         maximum speed with fpute is limited to about 1/3 the normal character
  237.  
  238.  
  239.         (C) 1988 Omen Tech Inc                    Chapter 13 Message Transfers
  240.  
  241.  
  242.         Version 17.32 TurboDial 2.33            Universal Line Printer Edition
  243.         ZCOMM User Manual                                                   65
  244.  
  245.  
  246.         rate by echo delays.  There is no error correction with fpute.  If
  247.         possible, TABS should be set to echo as TAB characters and not as
  248.         spaces.  Before the fpute command is given, the remote system must be
  249.         instructed to enter data from the "terminal" to a file.  After the
  250.         file has been sent, the remote system must be instructed to close the
  251.         file.
  252.  
  253.         EXAMPLE: fpute file1
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269.  
  270.  
  271.  
  272.  
  273.  
  274.  
  275.  
  276.  
  277.  
  278.  
  279.  
  280.  
  281.  
  282.  
  283.  
  284.  
  285.  
  286.  
  287.  
  288.  
  289.  
  290.  
  291.  
  292.  
  293.  
  294.  
  295.  
  296.  
  297.  
  298.  
  299.         (C) 1988 Omen Tech Inc                         Chapter 13 Flow Control
  300.  
  301.  
  302.         Version 17.32 TurboDial 2.33            Universal Line Printer Edition
  303.         ZCOMM User Manual                                                   66
  304.  
  305.  
  306.         14.  FLOW CONTROL
  307.  
  308.         Flow control is sometimes necessary for displaying long messages and
  309.         file transfer protocols that use long blocks or streaming.  If you see
  310.         pieces of text missing from messages but don't see the usual funny
  311.         characters caused by line noise, suspect a flow control problem.  With
  312.         ZMODEM and other streaming protocols, inexplicable retransmissions of
  313.         data blocks, often at regular intervals, indicate flow control
  314.         failure.
  315.  
  316.         When using error correcting modems and/or packet switched networks,
  317.         including "PC Pursuit", flow control regulates the speed of data
  318.         transmission to the network's capabilities, preventing loss of data.
  319.  
  320.         To keep things simple, the sending computer should not operate at a
  321.         higher interface speed than the slowest link in the network.  When
  322.         this guideline is not met, subtle precautions must be taken for best
  323.         results with interactive operations and streaming file transfer
  324.         protcols.
  325.  
  326.         ZCOMM, ZCOMM, and DSZ default to software flow control with XON and
  327.         XOFF characters.  When used with modems that require hardware flow
  328.         control, the handshake command (q.v.) should be used to specify which
  329.         hardware lines are to be used for flow control.
  330.  
  331.         Non transparent software flow control is incompatible with XMODEM and
  332.         YMODEM transfers.  XMODEM and YMODEM require complete transparency to
  333.         all 256 8 bit codes.  An XMODEM transfer that always fails at the same
  334.         block results from non transparent flow control.  When XMODEM-1k and
  335.         YMODEM-1k are used, the network must assert flow control, or handle
  336.         bursts of 1040 characters without data loss.  When X.25 or hardware
  337.         CTS is unavailable, flow control that does not "eat" any characters
  338.         may be used with XMODEM and YMODEM.  When buffers fill up, an XOFF
  339.         should be emitted.  An XON should be sent when the buffer has emptied.
  340.         Otherwise, the network should neither generate nor eat XON or XOFF
  341.         characters.
  342.  
  343.         On Telenet, this is obtained by setting CCIT X3 5:1 and 12:1 in the
  344.         PADs (Packet Assembler Dissassembler) at both ends of the network.
  345.         Packets should be forwarded when the packet is a full 128 bytes, or
  346.         after a moderate delay (3:0,4:10).
  347.  
  348.         With PC-Pursuit, one may set parameter 5 to 1 at both ends AFTER one
  349.         is connected to the remote modem.  (Sorry, these commands must be
  350.         given each time you connect to a modem in the far city!)
  351.  
  352.              <ENTER>@<ENTER>
  353.              set 5:1<ENTER>
  354.              rst? 5:1<ENTER>
  355.              cont<ENTER> ZMODEM and Kermit protect all 4 XOFF and XON
  356.         characters, commonly used network control characters and trigger
  357.  
  358.  
  359.         (C) 1988 Omen Tech Inc                         Chapter 14 Flow Control
  360.  
  361.  
  362.         Version 17.32 TurboDial 2.33            Universal Line Printer Edition
  363.         ZCOMM User Manual                                                   67
  364.  
  365.  
  366.         strings.  ZMODEM and Kermit are compatible with many networks that do
  367.         not support XMODEM family protocols, including some that claim network
  368.         compatibility.  For PADs that do not accept "rst?", use:
  369.  
  370.              <ENTER>@<ENTER>
  371.              set 4:2,5:1,12:1<ENTER>
  372.              cont<ENTER>
  373.  
  374.         For best Telenet download throughput, parameter 64 (advance ACK)
  375.         should be set to 7.  The parameter 0 is a dummy argument that
  376.         distinguishes Telenet parameters from CCIT parameters.
  377.  
  378.              <ENTER>@<ENTER>
  379.              set 0:0,64:7<ENTER>
  380.              cont<ENTER>
  381.  
  382.         Sometimes Telenet flow control stops data transmission when the
  383.         network buffers are not yet full.  If you often see "STOPPED" flashing
  384.         in the status line (DOS versions), or if you see the modem send data
  385.         light pause in a ZMODEM or SuperKermit file send, poor flow control
  386.         may be the culprit.  Such slowdowns are typical when a network is
  387.         overloaded.  If this condition persists, the network should take steps
  388.         to reduce the congestion.  Turning OFF network flow control and
  389.         activating ZMODEM's or SuperKermit's protocol flow control may
  390.         increase throughput under these conditions.
  391.  
  392.         Instead of or in addition to XON/XOFF flow control, the sending
  393.         program's ZMODEM w numeric parameter can restrict the window size to a
  394.         value that does not overload the network.  A zmodem pw2048 command
  395.         restricts the window size (maximum number of bytes in transit) to
  396.         2048.  This causes the sz command to trigger the receiver's
  397.         acknowledgement every 512 bytes (one fourth the value of the ZMODEM w
  398.         numeric parameter).  The sender monitors these responses and suspends
  399.         transmission when necessary to restrict the window to the specified
  400.         size.  Until a network dependent lower limit is reached, lower window
  401.         sizes improve the speed of error recovery at the expense of slight
  402.         increases in protocol overhead.  When the window size becomes less
  403.         than the number of characters sent within the network's transit time,
  404.         throughput falls off rapidly.
  405.  
  406.         Frequent protocol acknowledgements slow down high speed psuedo full
  407.         duplex modems and should be avoided.
  408.  
  409.         Some modems and networks can be configured to flush (discard the
  410.         contents of) their buffers when a break signal is received.  If this
  411.         is possible, error recovery with ZMODEM transfers may be speeded up by
  412.         setting the ZMODEM b parameter to 1, which sends a break whenever the
  413.         ZMODEM sending program receives a retransmission request.
  414.  
  415.  
  416.  
  417.  
  418.  
  419.         (C) 1988 Omen Tech Inc                         Chapter 14 Flow Control
  420.  
  421.  
  422.         Version 17.32 TurboDial 2.33            Universal Line Printer Edition
  423.         ZCOMM User Manual                                                   68
  424.  
  425.  
  426.                      Network and Flow Control (FC) Compatibility
  427.  
  428.         ______________________________________________________________________
  429.         |    Network     | Interactive | XMODEM | WXMODEM | S-KERMIT | ZMODEM |
  430.         |________________|_____________|________|_________|__________|________|
  431.         |No Network      | YES         | YES    | YES     | YES      | YES    |
  432.         |8 bit, no FC    | NO          | YES    | YES     | YES(1)   | YES(1) |
  433.         |Transparent FC  | YES         | YES    | YES     | YES      | YES    |
  434.         |Non Transparent | YES         | NO     | NO      | YES      | YES    |
  435.         |7 bit           | YES         | NO     | NO      | YES      | NO     |
  436.         |________________|_____________|________|_________|__________|________|
  437.  
  438.         (1) Window size must be restricted to avoid buffer overrun if the
  439.         network cannot transfer data at full speed.  Got ZRPOS indicates the
  440.         receiving program has detected a transmission error and has requested
  441.         retransmission.  In other words, ZMODEM is doing its job of detecting
  442.         and correcting missing and garbled data.  If this happens more often
  443.         than observed line errors would indicate is reasonable, there may be a
  444.         flow control problem in one of four areas:
  445.  
  446.           + Between the sending program and its modem.  If using an interface
  447.             speed higher than the transmission speed, or modem to modem error
  448.             correction (MNP, LAPB, PEP, etc.), check that the modem and the
  449.             sending program are configured for the same flow control methods.
  450.             Omen Technology's software is faster than most other programs, and
  451.             may expose flow control problems not seen with slower software.
  452.  
  453.           + Between the sending modem and the network.  Correcting this
  454.             requires "handshake both" to allow the sending program to honor
  455.             both hardware (CTS) flow control from the modem and software flow
  456.             control (XON/XOFF) from the network.
  457.  
  458.           + Between parts of the network.
  459.  
  460.           + Between the receiving modem and the receiving program.  This can
  461.             happen at high transmission speeds when the receiver has specified
  462.             a large I/O buffer size with the B numeric parameter.
  463.  
  464.             Excessive interrupt latency from extended memory ramdisks or disk
  465.             caches, and poorly written hard disk drivers also wreak havoc on
  466.             streaming protocols but do not affect start-stop protocols
  467.             (XMODEM, etc.).
  468.  
  469.             To correct these problems, give the "handshake slow" command to
  470.             the receiver.
  471.  
  472.  
  473.  
  474.  
  475.  
  476.  
  477.  
  478.  
  479.         (C) 1988 Omen Tech Inc                       Chapter 14 Running ZCOMM
  480.  
  481.  
  482.         Version 17.32 TurboDial 2.33            Universal Line Printer Edition
  483.         ZCOMM User Manual                                                   69
  484.  
  485.  
  486.         15.  RUNNING ZCOMM
  487.  
  488.         Before running ZCOMM, the keyboard Caps Lock should be turned off.
  489.         ZCOMM commands and most arguments must be entered in lower case.
  490.         ZCOMM is called from DOS as ZCOMM [DPORT=n] [command ...]
  491.         DPORT=n is an optional override to the initial default comm port.  If
  492.         another program is using the default comm port, ZCOMM must be told to
  493.         use another or interference will result.
  494.  
  495.         Command may be any desired combination of ZCOMM commands.  Command
  496.         line arguments to ZCOMM must be in lower case excpet as noted.
  497.  
  498.         EXAMPLE: C>ZCOMM call cissig invokes ZCOMM and executes the commands
  499.         in the "cissig" telephone directory entry.
  500.  
  501.  
  502.         EXAMPLE: C>ZCOMM DPORT=2 call othersys
  503.         Selects COM2 before initializing the serial port
  504.  
  505.  
  506.  
  507.         15.0.1  DOS Environment Variables  ZCOMM searches the DOS Environment
  508.         for the following variables:
  509.  
  510.         CBSIZE overrides the default allocation for the circular buffer.** If
  511.               memory is limited, the DOS command SET CBSIZE=3000 will leave
  512.               more memory for DOS Gateway or other programs.  On medium model
  513.               DOS flavors, CBSIZE may be set as high as 65500.
  514.  
  515.         DIRRX, DIRSX, DIRCX, DIRFX Contain optional receive (DIRRX), send
  516.               (DIRSX), capture (DIRCX), and file (DIRFX) directory presets.
  517.               When ZCOMM starts, these environment variables preset the dirrx,
  518.               dirsx, dircx, and dirfx string variables respectively.
  519.  
  520.         DIRSIZE controls the number of directory items that may be sorted with
  521.               each wildcard.  It should be set to 23 * times the desired
  522.               number of entries (default = 200).  If more directory entries
  523.               are encountered, they are processed without sorting.
  524.  
  525.               EXAMPLE: C>set DIRSIZE=8000
  526.  
  527.  
  528.         DPORT overrides the default modem port (com1) initially accessed by
  529.               ZCOMM.
  530.  
  531.               EXAMPLE: C>set DPORT=2
  532.  
  533.  
  534.         HOTPORT Suppresses the "Warning: Old dport=" message.
  535.  
  536.  
  537.  
  538.  
  539.         (C) 1988 Omen Tech Inc                       Chapter 15 Running ZCOMM
  540.  
  541.  
  542.         Version 17.32 TurboDial 2.33            Universal Line Printer Edition
  543.         ZCOMM User Manual                                                   70
  544.  
  545.  
  546.         MODEM Describes the type of modem used by the mm224 script.  See
  547.               Chapter 7 for details.
  548.  
  549.               EXAMPLE: C>set MODEM=MM224E
  550.  
  551.  
  552.         PATH  must include the directories containing ZCOMM and the help
  553.               processor YHP.
  554.  
  555.         PHONES overrides the default pathname used to fetch ZCOMM's telephone
  556.               directory.  Forward slashes should be used to indicate
  557.               directories.
  558.  
  559.               EXAMPLE: C>set PHONES=c:/PHODIR.t
  560.  
  561.  
  562.         YAMQUIET Inhibits the display and locks the keyboard, preventing ZCOMM
  563.               from writing on the screen. * This is useful when calling ZCOMM
  564.               from another program.
  565.  
  566.               EXAMPLE: C>set YAMQUIET=1
  567.  
  568.  
  569.         ZONE  sets the z numeric parameter to the number of minutes the
  570.               current local time lags GMT time.
  571.  
  572.               EXAMPLE: C>set ZONE=420
  573.  
  574.  
  575.               SEE ALSO: z numeric parameter
  576.  
  577.  
  578.         15.0.2  Help Program Environment Variables  The flash-up help
  579.         processor program YHP examines the environmnet for the NORMATTR,
  580.         REVATTR, and UNDLATTR variables.  These set help screen parameters for
  581.         normal, reverse video, and underline attributes corresponding to the
  582.         n,r, and u numeric paramters.
  583.  
  584.         EXAMPLE: C>set NORMATTR=3
  585.  
  586.  
  587.  
  588.  
  589.  
  590.  
  591.  
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598.  
  599.         (C) 1988 Omen Tech Inc                         Chapter 15 Special Keys
  600.  
  601.  
  602.         Version 17.32 TurboDial 2.33            Universal Line Printer Edition
  603.         ZCOMM User Manual                                                   71
  604.  
  605.  
  606.         16.  SPECIAL KEYS
  607.  
  608.         Ctrl-Break clears any typeahead, unlocks the keyboard, and stops
  609.         whatever function[1] ZCOMM is doing in a reasonably orderly manner.[2]
  610.         Ctrl-Break cancels kbdlock.  It is not so abrupt as the NUKE key.  The
  611.         B test condition tests whether Ctrl-Break has been struck since the
  612.         last purgek command.
  613.  
  614.         Keyboarding ALT-N will NUKE (abort) the current command and return to
  615.         ZCOMM's command prompt.[3] If one or more scripts are active, the
  616.         current line number (counting from the first line in the script file)
  617.         for each level of script is displayed.* NUKE will terminate any
  618.         script.  NUKE closes any transmit file, but not a receive capture
  619.         file.  (A receive capture file may be closed with the "close"
  620.         command.) NUKE does not disconnect the modem by dropping DTR.[4]
  621.  
  622.         Keyboarding ALT-Z appends the contents of the display screen to a DOS
  623.         file.  The pathname is contained in the string parameter picture which
  624.         may be changed with the set command.  The exact contents of the screen
  625.         memory are written to the file, with each screen character followed by
  626.         its attribute.  A separate program, unpic is used to convert the
  627.         screen dump to a normal file that may be printed or displayed.
  628.  
  629.  
  630.         16.1  Special Keys during Protocol Transfers
  631.  
  632.         Certain keys perform special functions when keyboarded during protocol
  633.         file transfers (XMODEM, Kermit, etc.).
  634.  
  635.         F1  Keyboarding F1 causes a protocol timeout and forces a retry.
  636.  
  637.         ALT-A Displays Kermit file transfer status.
  638.  
  639.         ALT-B Cancels the current Kermit or ZMODEM batch transfer.
  640.  
  641.  
  642.  
  643.  
  644.         __________
  645.  
  646.          1. Not necessarily the calling function or script
  647.  
  648.          2. In the term function, Ctrl-Break sends a break to the remote
  649.             unless it has been redefined with a set command.
  650.  
  651.          3. Use of this term, popularized in the J.F.K. administration, does
  652.             not imply endorsement of preemptive nuclear attacks on innocent
  653.             populations.
  654.  
  655.          4. When in host operation waiting for a call, NUKE drops DTR.
  656.  
  657.  
  658.  
  659.         (C) 1988 Omen Tech Inc                         Chapter 16 Special Keys
  660.  
  661.  
  662.         Version 17.32 TurboDial 2.33            Universal Line Printer Edition
  663.         ZCOMM User Manual                                                   72
  664.  
  665.  
  666.         ALT-C Cancels the ZMODEM or Kermit session.
  667.  
  668.         ALT-F Skips the current ZMODEM or Kermit file transfer.
  669.  
  670.         ALT-Q Keyboarding Alt-Q during a protocol file transfer toggles a flag
  671.             that causes ZCOMM to disconnect when the transfer is completed.
  672.             This is most useful when downloading a long file.  As soon as the
  673.             file is transferred, ZCOMM will execute the string parameter
  674.             quitcmd (if set) and then disconnect the modem.  If keyboarded
  675.             during a Host Operation file transfer, ZCOMM will exit Host
  676.             Operation at the conclusion of the transfer.  The state of the
  677.             quit flag is displayed each time ALT-Q is keyboarded.
  678.  
  679.         ALT-S Keyboarding Alt-S displays status information on the console
  680.             screen only (even if in Host Operation).  The pattern number of
  681.             the last successful search (-1 if no match), the active search
  682.             patterns (if any), and the line numbers of the active scripts (if
  683.             any) are displayed to aid script debugging.
  684.  
  685.         ALT-V Keyboarding ALT-V will toggle the view option affecting the rb,
  686.             rc, rz, sb, sc, sx, and sz commands, and data transfers using the
  687.             Compuserve B protocol.
  688.  
  689.         ASCII Keyboarding a normal ASCII character (in the range of 00 to 7F)
  690.             will send that character to the modem.  This may be used for
  691.             protocol testing, or to terminate a modem's autodial handshake
  692.             without terminating ZCOMM's call retry count.
  693.  
  694.         Ctrl-X All ZMODEM and many YMODEM and XMODEM protocol programs
  695.             recognize a dozen successive Ctrl-X characters as a session abort
  696.             command.  If the remote computer appears to be "stuck" in a YMODEM
  697.             or ZMODEM transfer, keyboard ten Ctrl-X characters to abort the
  698.             protocol transfer.
  699.  
  700.         During a protocol transfer, normal keys are sent to the modem when
  701.         Zcomm is waiting for or receiving a packet.  This may be used to
  702.         reissue a file transfer command to the other computer if it becomes
  703.         apparent the original command was not accepted.
  704.  
  705.         Other uses for this pass thru capability include protocol testing.
  706.  
  707.         16.2  Local Editing Keys
  708.  
  709.         Emacs style character editing reduces the number of keystrokes needed
  710.         to enter and edit commands and strings.  Normally, the cursor is at
  711.         the end of the line of text being keyboarded.  Printing characters
  712.         insert themselves at the cursor location.  The <ENTER> key enters the
  713.         entire line of text.
  714.  
  715.         Editing keys are:
  716.  
  717.  
  718.  
  719.         (C) 1988 Omen Tech Inc                   Chapter 16 Local Editing Keys
  720.  
  721.  
  722.         Version 17.32 TurboDial 2.33            Universal Line Printer Edition
  723.         ZCOMM User Manual                                                   73
  724.  
  725.  
  726.         Left, Ctrl-B moves the cursor to the left
  727.  
  728.         Right, Ctrl-F moves the cursor to the right
  729.  
  730.         Ctrl-Left cursor WORD left
  731.  
  732.         Ctrl-Right cursor WORD right"
  733.  
  734.         Ctrl-A cursor to beginning of line
  735.  
  736.         Ctrl-E cursor to end of line
  737.  
  738.         Del, Ctrl-D delete character at cursor
  739.  
  740.         Backspace delete character to left of cursor
  741.  
  742.         Ctrl-W delete word to left of cursor
  743.  
  744.         Ctrl-K delete to end of line
  745.  
  746.         Ctrl-R refresh (redisplay) the line
  747.  
  748.         Ctrl-X delete entire line
  749.  
  750.         Down, Ctrl-N next history line
  751.  
  752.         Up, Ctrl-P previous history line
  753.  
  754.         Ctrl-U Argument Count (not available in term function)
  755.  
  756.         An initial Ctrl-U sets an argument count of 4.  Successive Ctrl-U
  757.         characters multiply the argument count by 4.  A decimal number may be
  758.         entered after Ctrl-U, and this number becomes the argument count.
  759.  
  760.         EXAMPLE: ^U^U Left moves the cursor 16 left
  761.  
  762.  
  763.         EXAMPLE: ^U5X inserts 5 "X" characters
  764.  
  765.  
  766.         EXAMPLE: ^U5^U?  inserts 20 "?" characters.
  767.  
  768.         Unix/Xenix flavors do not support Emacs style editing in the term
  769.         function.
  770.  
  771.  
  772.  
  773.  
  774.  
  775.  
  776.  
  777.  
  778.  
  779.         (C) 1988 Omen Tech Inc                        Chapter 16 Main Commands
  780.  
  781.  
  782.         Version 17.32 TurboDial 2.33            Universal Line Printer Edition
  783.         ZCOMM User Manual                                                   74
  784.  
  785.  
  786.         17.  MAIN COMMANDS
  787.  
  788.         17.1  Main Commands
  789.  
  790.         All commands and arguments must be entered in lower case except where
  791.         stated.
  792.  
  793.         You may shorten some commands by typing just the first portion that is
  794.         shown in caps.  For example, the "break" command may be entered as
  795.         "br".  Whether or not you abbreviate the command, it must be entered
  796.         in lower case.
  797.  
  798.         User defined Soft Keys are executed from the command prompt iff they
  799.         do not conflict with the permanent definitions described below.
  800.  
  801.         Except where stated, multiple commands can be written on one line
  802.         separated by ; (semicolon).  Commands that take a constant number of
  803.         arguments do not need a semicolon to delimit the end of the command.
  804.         If in doubt, use a semicolon to separate multiple commands.[1]
  805.  
  806.         @ The at sign may be used to indicate a telephone number starting with
  807.           the Touch-Tone(TM) A B C D * or # codes or a character escape.  If
  808.           the phone number contains spaces, it must be enclosed in double
  809.           quotes.  The leading @ is not sent to the modem.
  810.  
  811.           EXAMPLE: @#*-123-4567 Dials #*-123-4567.
  812.  
  813.  
  814.         %l-234-567-8901 (%l:letter l) For normal long distance dialing, the
  815.           string parameter l (letter l) defaults to "1" (digit 1).  To use an
  816.           alternative long distance service, set the l string parameter with a
  817.           modem command to dial the local access number, wait for the second
  818.           dial tone, and transmit the account number.
  819.  
  820.           SEE ALSO: "setsavenet" telephone directory entry
  821.  
  822.           A string of alternate phone numbers may be specified with the "+"
  823.           construction shown below.
  824.  
  825.         234-5678 A number given as a command invokes the dial script to
  826.           attempt a connection with the specified number.  Iff the modem is
  827.           currently connected to a remote modem, and the B numeric parameter
  828.           is non zero, ZCOMM pulses Data Terminal Ready, terminating the
  829.           connection.  ZCOMM character escapes may be used within the number
  830.  
  831.  
  832.         __________
  833.  
  834.          1. A space or two after each semicolon makes scripts easier for
  835.             humans to read.
  836.  
  837.  
  838.  
  839.         (C) 1988 Omen Tech Inc                        Chapter 17 Main Commands
  840.  
  841.  
  842.         Version 17.32 TurboDial 2.33            Universal Line Printer Edition
  843.         ZCOMM User Manual                                                   75
  844.  
  845.  
  846.           string to represent special characters.
  847.  
  848.           EXAMPLE: 234-5678
  849.  
  850.  
  851.           When carrier is detected, ZCOMM executes the mconnect string (if
  852.           set) and proceeds to the next command
  853.  
  854.           One or several alternate phone numbers may be specified by appending
  855.           the previous number with +234-5678 for as many alternate numbers as
  856.           are desired.  When a connection is made, undialed alternates are
  857.           forgotten.  Alternate phone numbers need not support the same
  858.           speeds.  A redial count given to the call command repeats the
  859.           sequence of alternate numbers.
  860.  
  861.           EXAMPLE: cis             speed 2400 239-6124/mnp_s+239-
  862.           6126/mnp_s+232-1032/300
  863.           This script line attempts a MNP (with software handshake) call to
  864.           the first two numbers, then a 300 bps call to the third number if
  865.           neither of the first two connected.
  866.  
  867.  
  868.           Iff no connection is made, script processing at the current level is
  869.           terminated.
  870.  
  871.           A number of modifiers are available depending on the type of modem
  872.           and the choice of dialing script used.  These are described in
  873.           Chapter 7.
  874.  
  875.  
  876.           SEE ALSO: nolog command, calllog string parameter, mcommand string
  877.           parameter
  878.  
  879.         a: Change the default disk to a:.  ZCOMM then prints the free storage
  880.           remaining on the selected disk.  The specified disk must be included
  881.           in the string parameter disks.
  882.  
  883.         abort Aborts any command or script in progress.  Closes all script
  884.           files that may be open.  Abort returns to the command prompt.
  885.  
  886.           SEE ALSO: quit command
  887.  
  888.         accept[[l]1] stringvar prompt (letter l, digit 1) Scripts often need
  889.           to prompt the user for file names and menu choices.
  890.  
  891.           Accept displays Prompt[2] to the user.  ZCOMM then reads keyboard
  892.  
  893.  
  894.  
  895.  
  896.  
  897.  
  898.  
  899.         (C) 1988 Omen Tech Inc                        Chapter 17 Main Commands
  900.  
  901.  
  902.         Version 17.32 TurboDial 2.33            Universal Line Printer Edition
  903.         ZCOMM User Manual                                                   76
  904.  
  905.  
  906.           input into the specified string variable.  Backspace and Ctrl-U
  907.           perform editing functions.  Characters are accepted from the user
  908.           until <ENTER> is typed.  If the H numeric is non zero, an empty
  909.           string is returned if <ENTER> is not typed within the time limit set
  910.           by that parameter.  Acceptl translates the user's response to lower
  911.           case.  Acceptl1 returns a 1 character string in lower case after the
  912.           single character is keyboarded.
  913.  
  914.           Prompt is processed for string substitution and character escapes.
  915.           If the result begins with an ESC character, ZCOMM does not
  916.           reposition the cursor before accepting the string.  In writing
  917.           scripts, it may be useful to save the current screen location with
  918.           an escape sequence, then restore it with an escape sequence encoded
  919.           in the prompt string.
  920.  
  921.           EXAMPLE: accept s1 File: Displays the prompt File: and reads the
  922.           keyboarded response to string parameter s1.
  923.  
  924.  
  925.           EXAMPLE: acceptl1 s0 "Enter Menu Choice" Reads a single character
  926.           from the user, translates it to lower case, and assigns it to s0.
  927.  
  928.  
  929.           EXAMPLE: accept s0 "\E[20;60H\E[KFile Name: " Places the cursor at
  930.           line 20 column 60, clears the rest of the CRT line, displays the
  931.           prompt, and accepts input.
  932.  
  933.  
  934.           EXAMPLE: accept s6 " Your \E[1mFirst\E[0m name please " Uses
  935.           boldface video to highlight First as it appears in the prompt.
  936.  
  937.  
  938.           EXAMPLE: accept s2 "File "; rc %s2 Prompts the user for a file name,
  939.           then receives that file with XMODEM/CRC protocol.
  940.  
  941.  
  942.           EXAMPLE: accept xpassword "\E[mMaster Password: \E[8m"; lput "\E[m"
  943.           Uses invisible video (ESC [ 8 m) to allow a password to be entered
  944.           without visible echo.  The ESC [ m sequences reset the display to
  945.           normal (visible).
  946.  
  947.  
  948.           SEE ALSO: obey command, scripts
  949.  
  950.  
  951.  
  952.  
  953.         ______________________________________________________________________
  954.  
  955.          2. Prompt must be enclosed in quotes if it contains spaces.
  956.  
  957.  
  958.  
  959.         (C) 1988 Omen Tech Inc                        Chapter 17 Main Commands
  960.  
  961.  
  962.         Version 17.32 TurboDial 2.33            Universal Line Printer Edition
  963.         ZCOMM User Manual                                                   77
  964.  
  965.  
  966.         ap file1 file2* (Append) Appends the contents of file1 to file2.  If
  967.           file2 does not exist, it is created.  Wildcards are not allowed.
  968.           The ap command closes any files that have been opened by the create,
  969.           f, open, t or > commands.  File1 and file2 are processed for string
  970.           parameter substitution.
  971.  
  972.         apd file1 file2* (Append-Delete) Appends the contents of file1 to
  973.           file2, then deletes file1.  If file2 does not exist, it is created.
  974.           If an error is detected writing file2, file1 is not deleted.
  975.           Wildcards are not allowed.  The apd command closes any files that
  976.           have been opened by the create, f, open, t or > commands.  File1 and
  977.           file2 are processed for string parameter substitution.
  978.  
  979.           EXAMPLE: apd %item Z%item.tmp
  980.  
  981.  
  982.         bdump outfile Dumps the contents of the modem interrupt input buffer
  983.           to outfile.  This command is useful for debugging as outfile will
  984.           contain the last characters received from the remote regardless of
  985.           what ZCOMM commands have been executed.  The most recently received
  986.           data appears at the end of outfile.  This command "tells it as it
  987.           is", writing all 8 bits of each character to outfile.  If less than
  988.           1400 characters have been received from the remote, some of outfile
  989.           will consist of nulls or garbage.  The bdump command is often used
  990.           as a post mortem diagnostic dump after a failed script or file
  991.           transfer.
  992.  
  993.         bg Indicates ZCOMM is running in the background with no user at the
  994.           keyboard.
  995.  
  996.           SEE ALSO: fg command, df test condition
  997.  
  998.         BReak Sends a 200 millisecond break signal.
  999.           NOTE: Some modems do not correctly pass the break signal to the
  1000.           remote.
  1001.  
  1002.           SEE ALSO: Ctrl-Break key, break string parameter, zmodem B numeric
  1003.           parameter
  1004.  
  1005.         BROwse pathspec Browse through the files specified in pathspec.  If
  1006.           pathspec is empty, all files are presented.  For each matched
  1007.           pathname, the filename, date, and length of the file are displayed.
  1008.           The status line displays some of the commands which may be applied
  1009.           to each file.  Chapter 15.4 describes the browse subcommands, which
  1010.           provide extensive capabilities for individually selected files.
  1011.  
  1012.         bye Terminate the connection in progress by sending a long space and
  1013.           then dropping DTR (Data Terminal Ready).[3] After a pause, DTR is
  1014.  
  1015.  
  1016.  
  1017.  
  1018.  
  1019.         (C) 1988 Omen Tech Inc                        Chapter 17 Main Commands
  1020.  
  1021.  
  1022.         Version 17.32 TurboDial 2.33            Universal Line Printer Edition
  1023.         ZCOMM User Manual                                                   78
  1024.  
  1025.  
  1026.           reasserted to allow the modem to originate or answer another
  1027.           call.[4]
  1028.  
  1029.           SEE ALSO: o, off commands
  1030.  
  1031.         call [-N] name[.path][,modifier] Prepare ZCOMM for a new task and
  1032.           invoke an entry in the Phone Directory.
  1033.  
  1034.           The 7, A, a, b, C, c, E, e, g, H, h, i, j, n, o, P, p, q, r, S, s,
  1035.           t, u, v, w, X, x, Z, and z modes are reset.  The d mode is set.  The
  1036.           e, f, g, k, m, p, q, t, w, Kermit 8, zmodem C, e, l, L, p, t, T, w,
  1037.           and W parameters are reset to their default values.  The search
  1038.           patterns are erased.  Permanent string parameters set with the set
  1039.           _svar command are set to empty.
  1040.  
  1041.           If path has been specified, it is searched for a line beginning with
  1042.           name.  Otherwise, ZCOMM searches the telephone directory.  An
  1043.           optional modifier (string with a leading comma), if specified, is
  1044.           not used in the directory search.
  1045.  
  1046.           If the search is successful, the entire directory entry name is
  1047.           copied to the remote string parameter.  The complete argument
  1048.           entered on the command line is stored in the args string parameter
  1049.           visible to the called script.  If the script has a READ ONLY
  1050.           attribute, ZCOMM is unrestricted during execution of the script.
  1051.           ZCOMM then executes the commands on the rest of the line (if any),
  1052.           and on succeeding lines beginning with a space or tab.  If the v
  1053.           numeric parameter is greater than zero, each command from the file
  1054.           is displayed on the screen before it is executed.
  1055.  
  1056.           It is not necessary to type the entire name as it appears in the
  1057.           telephone directory, as ZCOMM will find the first entry that name is
  1058.           a prefix of.  Iff name is empty, execution begins with the first
  1059.           line of path.
  1060.  
  1061.           EXAMPLE: call cis1200
  1062.                           call cis1
  1063.                           call cis.C:/newscript
  1064.  
  1065.  
  1066.           EXAMPLE:                 call genie,upl Invokes the genie telephone
  1067.           directory entry with the modifier ,upl available to the called
  1068.  
  1069.  
  1070.         ______________________________________________________________________
  1071.  
  1072.          3. The modem must be configured to use Data Terminal Ready (DTR).
  1073.  
  1074.          4. Most dialing scripts include an initial bye command to make sure
  1075.             any previous call is disconnected.
  1076.  
  1077.  
  1078.  
  1079.         (C) 1988 Omen Tech Inc                        Chapter 17 Main Commands
  1080.  
  1081.  
  1082.         Version 17.32 TurboDial 2.33            Universal Line Printer Edition
  1083.         ZCOMM User Manual                                                   79
  1084.  
  1085.  
  1086.           script.
  1087.  
  1088.           The call command is not limited to making connections.  For example,
  1089.           "call host" in the distribution PHODIR.t file conditions a Hayes
  1090.           compatible modem to answer incoming calls silently, set parameters,
  1091.           and activates ZCOMM's host operation.
  1092.  
  1093.           Most directory entries include a telephone number to dial.  If ZCOMM
  1094.           is used with an autodial modem, the number of retries N (default
  1095.           none) may be specified.
  1096.  
  1097.           EXAMPLE: call -40 cbbs-r Attempts 40 retries before giving up.
  1098.  
  1099.           The interval between retries is set by the i numeric parameter.
  1100.  
  1101.           EXAMPLE: pi4 Sets the interval between retries to 4 seconds.
  1102.  
  1103.           Words To the Wise: Abuse of the retry feature by continually calling
  1104.           busy numbers may incur the wrath of the Telephone Company.
  1105.           Especially with Message Unit Accounting, Big Brother may be watching
  1106.           your telecommunications habits.  Some long distance services (MCI,
  1107.           Sprint, AT&T, etc.) charge for unsuccessful calls, especially if the
  1108.           phone is allowed to ring (or ring busy) for more than a few seconds.
  1109.  
  1110.           Consult your telephone company about legal limits to the number and
  1111.           frequency of retries.
  1112.  
  1113.           Since some computer services will disconnect within a short time if
  1114.           no login is attempted, you should start communicating as soon as the
  1115.           modems are connected.  ZCOMM sounds the bell after making the
  1116.           connection if retries have been specified.
  1117.  
  1118.           The source, gosub and call commands may be nested with up to six
  1119.           command/phones file descriptors open at once.[5] A label may be the
  1120.           target of a call command provided the trailing colon is included in
  1121.           name.
  1122.  
  1123.         cat pathspec For Unix users, a synonym to the type command (q.v.).
  1124.  
  1125.         cd [dir] Change to directory dir.  If Restricted, dir is checked for a
  1126.           parent directory ("cd .."), and absolute paths ("cd /src") not
  1127.           prefixed by the home string parameter.  Giving cd without an
  1128.           argument changes to the directory stored in the home string
  1129.           parameter.[6] ZCOMM then stores the current directory in the pwd
  1130.  
  1131.  
  1132.         __________
  1133.  
  1134.          5. Deep nesting may require a decrease in the circular buffer memory
  1135.             allocation, see Chapter 14.
  1136.  
  1137.  
  1138.  
  1139.         (C) 1988 Omen Tech Inc                        Chapter 17 Main Commands
  1140.  
  1141.  
  1142.         Version 17.32 TurboDial 2.33            Universal Line Printer Edition
  1143.         ZCOMM User Manual                                                   80
  1144.  
  1145.  
  1146.           string parameter and displays it unless the v numeric parameter is
  1147.           less than 0.
  1148.  
  1149.           EXAMPLE: cd /tmp
  1150.  
  1151.           NOTE: When operating restricted, the home string parameter must
  1152.           point to a valid directory in order to enforce the intended
  1153.           directory path restriction.
  1154.  
  1155.           SEE ALSO: cdd and pwd commands, home and pwd string parameters
  1156.  
  1157.         cd D:dir When a disk drive is specified with the cd command, the
  1158.           current directory on that drive is changed but ZCOMM remains logged
  1159.           in on the current drive and directory.  If Restricted, dir is
  1160.           checked for a disk drive ("cd b:/foo") not contained in the disks
  1161.           string parameter.
  1162.  
  1163.           EXAMPLE: cd D:/tmp
  1164.  
  1165.  
  1166.         cdd D:dir Change to (log in to) disk D and then to directory dir on
  1167.           the specified disk.  If dir is not specified, the root directory is
  1168.           assumed.  ** This is a shorthand equivalent to a D: command followed
  1169.           by a chdir dir command.
  1170.  
  1171.           SEE ALSO: cd command
  1172.  
  1173.         chat Enter the term function to chat keyboard to keyboard.  Characters
  1174.           typed by either keyboard are echoed to both ends, and RETURNS echo
  1175.           as RETURN/LINEFEED.  Chat will become hostile if the other end also
  1176.           echoes characters.  (Try it sometime on a timesharing system; it's
  1177.           fun.) In Host Operation, chat exits if the caller types Ctrl-Z.
  1178.  
  1179.         chek pathspec Print the "chek" CRC-16 and character count for the
  1180.           specified files.  The CRC-16 used is the 16 bit Cyclical Redundancy
  1181.           Check used by the public domain CHEK.COM program.  The chek command
  1182.           verifies the identity of two (or more) copies of a file.  Iff the
  1183.           lengths and CRC-16's of two files are the same, the files are almost
  1184.           certainly identical.  Comparing files with the chek command is
  1185.           faster than transmitting a second copy for character by character
  1186.           comparisons.
  1187.  
  1188.           EXAMPLE: chek *.c
  1189.  
  1190.  
  1191.  
  1192.         ______________________________________________________________________
  1193.  
  1194.          6. The home parameter is set to the current directory when ZCOMM is
  1195.             invoked, but may be changed with the set command.
  1196.  
  1197.  
  1198.  
  1199.         (C) 1988 Omen Tech Inc                        Chapter 17 Main Commands
  1200.  
  1201.  
  1202.         Version 17.32 TurboDial 2.33            Universal Line Printer Edition
  1203.         ZCOMM User Manual                                                   81
  1204.  
  1205.  
  1206.           HINT: To generate a file containing the CRC's of the files in the
  1207.           current directory:
  1208.  
  1209.                           >chek.lst
  1210.                           chek *.*
  1211.                           close
  1212.  
  1213.           After the files are copied, run the commands above (with a different
  1214.           file name), then compare the two files with DIF.EXE to detect any
  1215.           that have changed.
  1216.  
  1217.           SEE ALSO: crc, sum, wc commands
  1218.           Source for a public domain Unix version of CHEK is available.
  1219.  
  1220.         close Writes the contents of the circular buffer iff a receive file is
  1221.           open, then closes the receive and transmit files.  ZCOMM complains
  1222.           if no files were open.
  1223.  
  1224.           SEE ALSO: nolog command
  1225.  
  1226.         closerx Iff a receive file is open, writes the circular buffer then
  1227.           closes the receive file.
  1228.  
  1229.           SEE ALSO: nolog command
  1230.  
  1231.         closetx Closes the transmit file, if it is open.
  1232.  
  1233.           SEE ALSO: nolog command
  1234.  
  1235.         cl Clears the screen.
  1236.  
  1237.         cls Resets display modes and clears the screen.
  1238.  
  1239.         CONFerence Enters the term function with a 1 line window for composing
  1240.           commands and text.  Chapter 19.5 gives details.
  1241.  
  1242.         crc pathspec Print the CRC-32 and character count for the specified
  1243.           files.  The crc command verifies the identity of two (or more)
  1244.           copies of a file.  Iff the lengths and CRC-32's of two files are the
  1245.           same, the files are almost certainly identical.  Comparing files
  1246.           with the crc command is faster than transmitting a second copy for
  1247.           character by character comparisons.
  1248.  
  1249.           EXAMPLE: "crc", "crc *.c"
  1250.  
  1251.  
  1252.           SEE ALSO: chek, sum, wc commands
  1253.           Source for a public domain Unix/DOS version of CRC is available.
  1254.           The crc command is available with flavors of ZCOMM with ZMODEM.
  1255.  
  1256.  
  1257.  
  1258.  
  1259.         (C) 1988 Omen Tech Inc                        Chapter 17 Main Commands
  1260.  
  1261.  
  1262.         Version 17.32 TurboDial 2.33            Universal Line Printer Edition
  1263.         ZCOMM User Manual                                                   82
  1264.  
  1265.  
  1266.         create [-modes] outfile If a receive capture file is open as the
  1267.           result of a create or t filename command, write the circular buffer
  1268.           and close it.  Then create outfile for use with the term function
  1269.           with modes.  The create command is especially useful when you don't
  1270.           want to enter the term function immediately.
  1271.  
  1272.           EXAMPLE: create -ys /tmp/cbbs.tmp"[7]
  1273.  
  1274.  
  1275.           SEE ALSO: > command
  1276.  
  1277.         createx outfile Similar to the create command, but does not open
  1278.           outfile if a file with the same pathname already exists.  The
  1279.           resulting error message may be suppressed by setting the v numeric
  1280.           parameter negative.  Scripts may test for success with the r test
  1281.           condition.  The createx command may be used to manage semaphores to
  1282.           lock resources or work entries used by multiple instances of a
  1283.           program.  The createx command is available on Unix and OS/2 flavors.
  1284.  
  1285.           SEE ALSO: kill command
  1286.  
  1287.         del pathspec Delete the specified files.  No message is printed if
  1288.           files could not be deleted.  No confirmation is requested for
  1289.           massive deletes.
  1290.  
  1291.           WARNING: As with all ZCOMM pathspec specifications, a directory name
  1292.           expands to all files in that directory.
  1293.           N.B.: Do not attempt to delete an open file on DOS, especially the
  1294.           history file.
  1295.  
  1296.           SEE ALSO: browse command
  1297.  
  1298.         demand password Scripts must often verify a caller's identity by
  1299.           asking for a password.  The ZCOMM password command allows a caller
  1300.           three chances to enter a given password.  Failure results in
  1301.           disconnection.
  1302.  
  1303.           Password is processed for character escapes and string
  1304.           substitutions.  All security restrictions on string parameters are
  1305.           enforced.
  1306.  
  1307.           If the result is empty, no password is demanded.  Otherwise the user
  1308.           is prompted to enter a string matching password in the correct case.
  1309.           Keyboard input is not echoed.
  1310.  
  1311.  
  1312.         __________
  1313.  
  1314.          7. The y mode overwrites any existing file with the same name.  The s
  1315.             mode strips most control characters from the resulting disk file.
  1316.  
  1317.  
  1318.  
  1319.         (C) 1988 Omen Tech Inc                        Chapter 17 Main Commands
  1320.  
  1321.  
  1322.         Version 17.32 TurboDial 2.33            Universal Line Printer Edition
  1323.         ZCOMM User Manual                                                   83
  1324.  
  1325.  
  1326.           Three attempts to enter password are allowed.  If the password is
  1327.           not correctly entered, DTR is pulsed to force the modem to
  1328.           disconnect the caller, and the ?  numeric parameter is set negative.
  1329.  
  1330.           EXAMPLE: demand %password Requires the caller to enter a string
  1331.           matching the contents of the password string parameter.
  1332.  
  1333.  
  1334.         dir pathspec Display pathnames matching pathspec alphabetized across
  1335.           the page.  Wildcard filename expansions are alphabetical.
  1336.  
  1337.           EXAMPLE: dir
  1338.  
  1339.  
  1340.           EXAMPLE: dir y*.c *.h
  1341.  
  1342.  
  1343.         dirr pathspec Displays the directory with length and creation date of
  1344.           each file.  dirr displays the number of files matched, number of
  1345.           blocks, number of kb in those files, and estimated transmission time
  1346.           at the current transmission speed assuming the fastest protocol
  1347.           available (ZMODEM or YMODEM-g).  XMODEM and Kermit transfers take
  1348.           longer than the displayed estimates.  Wildcard filename expansions
  1349.           are alphabetical.
  1350.  
  1351.         dird pathspec Long Form directory, sorted by date.
  1352.  
  1353.         dirt pathspec Long Form directory, reverse sorted by date.
  1354.  
  1355.         dirl pathspec Long Form directory, sorted by file length.
  1356.  
  1357.         dirs pathspec Long Form directory, reverse sorted by file length.
  1358.  
  1359.         dirx pathspec Long Form directory, sorted by file extension.
  1360.  
  1361.         DISable{-modes} Disable mode(s) affecting the term function.  Chapter
  1362.           18 describes modes affecting the term function.
  1363.  
  1364.           EXAMPLE: dis -t Disables throttle (t mode).
  1365.  
  1366.  
  1367.         display [[no]dismode] ... Without an argument, prints the display
  1368.           modes.  Display modes preceded by NO are turned off.  With one or
  1369.           more arguments, turn on the specified display mode(s).  If an
  1370.           argument is preceded by no, the specified display mode is turned
  1371.           off.  The display modes are:
  1372.  
  1373.           nlmode Received newlines (linefeed) display as return/linefeed.
  1374.  
  1375.           bell=visual Instead of sounding on the speaker, bell characters
  1376.                 cause flashing notes to appear on the screen.
  1377.  
  1378.  
  1379.         (C) 1988 Omen Tech Inc                        Chapter 17 Main Commands
  1380.  
  1381.  
  1382.         Version 17.32 TurboDial 2.33            Universal Line Printer Edition
  1383.         ZCOMM User Manual                                                   84
  1384.  
  1385.  
  1386.           overstrike Overstruck characters are displayed in bold face or
  1387.                 underline (reverse video on CGA) as appropriate.
  1388.  
  1389.           lsi-adm3a Emulate Lear Siegler ADM3a and Televideo 9xx control
  1390.                 codes.
  1391.  
  1392.           autowrap The 81st character prints on a new line with possible
  1393.                 scrollup.
  1394.  
  1395.           stat=off Disables ZCOMM's status line.
  1396.  
  1397.           warpdrive Provides higher display speed without scrolling flicker,
  1398.                 but causes noise (snow/chromablizzard) with CGA display
  1399.                 adapters.
  1400.  
  1401.           vt100 Emulate DEC VT-100 and VT-102 display codes and most Teletype
  1402.                 5425 codes.  VT-52 and Zenith H-19 codes are the default.
  1403.  
  1404.           mapkb Allow escape codes from the remote or a file to active
  1405.                 alternate keyboard mapping.  The keyboard mapping is defined
  1406.                 with a series of mk commands, such as those contained in the
  1407.                 mk.std (standard keyboard) or mk.101 (101 key extended
  1408.                 keyboard) files.  Other mk.XXX files may be provided; the
  1409.                 first few lines of these files indicate the keyboard
  1410.                 configuration they set up.  ZCOMM comes initialized with the
  1411.                 mk.std mapping, which requires NumLock to be on.
  1412.  
  1413.                 EXAMPLE: source mk.std Defines a VT100 keyboard mapping for
  1414.                 standard PC and PC-AT keyboards.
  1415.  
  1416.                 The term function keyboard mapping enabled by the mapkb
  1417.                 command may override some ZCOMM functions.
  1418.  
  1419.           3101  Executes IBM 3101 and TI 940 escape codes.
  1420.  
  1421.           dumb  Only null, bs, tab, cr and lf are executed, all others
  1422.                 display.  As in real life, dumb takes precedence over vt100,
  1423.                 vt52, and lsi-adm3a emulation.
  1424.  
  1425.           inhibit Inhibits the display (nothing prints).
  1426.  
  1427.                 SEE ALSO: Q mode
  1428.           A display command argument changing the terminal emulation (vt100,
  1429.           lsi-adm3a, 3101, dumb) disables nlmode and overstrike.
  1430.           display nlmode nobell=visual Turns on nlmode display mode and turns
  1431.           off the visual bell.
  1432.  
  1433.  
  1434.           EXAMPLE: display vt100 Enables VT100/VT102 emulation used by many
  1435.           computer systems.
  1436.  
  1437.  
  1438.  
  1439.         (C) 1988 Omen Tech Inc                        Chapter 17 Main Commands
  1440.  
  1441.  
  1442.         Version 17.32 TurboDial 2.33            Universal Line Printer Edition
  1443.         ZCOMM User Manual                                                   85
  1444.  
  1445.  
  1446.         dump pathspec Dump the named files in a side by side hex/ASCII format,
  1447.           similar to the CP/M users' group DUMP program.  The ending character
  1448.           number is also displayed.  Zero length files are not displayed.
  1449.  
  1450.         echo[c|f] string Echo a line containing a single argument string in
  1451.           reverse video.  Tabs should not be used with the echo command.  The
  1452.           echoc command also echoes its argument to the capture file (if
  1453.           open), without reverse video.  The echof command echoes its argument
  1454.           to the capture file only.
  1455.  
  1456.           EXAMPLE: echoc "File not Accepted" Outputs a line to the screen and
  1457.           to the capture file.
  1458.  
  1459.  
  1460.           EXAMPLE: echo "Dave, This conversation can serve no further
  1461.           purpose." Displays a line on the screen only.
  1462.  
  1463.  
  1464.           SEE ALSO: lput command, r numeric parameter, character escapes
  1465.  
  1466.         egrep[m] regular-expression pathspec ** Display lines in the specified
  1467.           files matching regular-expression.  Regular Expressions are
  1468.           discussed in Chapter 23.
  1469.  
  1470.           The egrepm command finds a line matching regular-expression in each
  1471.           of the specified files, and then pages through the file beginning
  1472.           with the matched line.  At the end of each screen, ZCOMM accepts the
  1473.           same subcommands used with the findm command.
  1474.  
  1475.           EXAMPLE: egrep "^Subject:" *.* Displays all lines that begin with
  1476.           "Subject:".
  1477.  
  1478.  
  1479.           SEE ALSO: findmore command
  1480.  
  1481.           The egrep implementation does not strip the trailing CR/LF from
  1482.           lines read from the disk.  This affects use of the $ regular
  1483.           expression magic character.  When using the $ magic character, the
  1484.           CR/LF at the end of normal lines must be represented as "..$".
  1485.  
  1486.         egrepq regular-expression pathspec ** Silently searches the specified
  1487.           files for the first line matching regular-expression.  Upon a
  1488.           successful search, the contents of this line are stored in the z0
  1489.           string variable and the ?  numeric parameter is incremented.  The
  1490.           egrepq command is useful for fetching password information from a
  1491.           disk file.
  1492.  
  1493.           SEE ALSO: obey command, findq command
  1494.  
  1495.         else Execute the command(s) on the rest of the line if the last if
  1496.           test performed on the current script level was false.
  1497.  
  1498.  
  1499.         (C) 1988 Omen Tech Inc                        Chapter 17 Main Commands
  1500.  
  1501.  
  1502.         Version 17.32 TurboDial 2.33            Universal Line Printer Edition
  1503.         ZCOMM User Manual                                                   86
  1504.  
  1505.  
  1506.           NOTE: While else statements in programming languages are connected
  1507.           to a particular if statement according to syntax, the connection in
  1508.           ZCOMM is to the last if statement executed on the level, regardless
  1509.           of goto's.
  1510.  
  1511.         ENAble {-modes} Enable mode(s) affecting the term function.  Chapter
  1512.           18 describes modes affecting the term function.
  1513.  
  1514.           EXAMPLE: ena -h Enables half-duplex (local echo) Half-duplex mode
  1515.           causes the term function to display keyboarded characters.
  1516.  
  1517.  
  1518.         estimate length [speed] Use the specified length and optional
  1519.           specified effective speed for the next receive file to be created.
  1520.           A length of 0 bypasses the length substitution.  Once a speed (in
  1521.           effective bits per second) is given, it is used for all locally
  1522.           displayed transmission time calculations until the next speed or
  1523.           port command.
  1524.  
  1525.           EXAMPLE: "estimate z2" Uses the file length stored in string
  1526.           variable z2 in calculating the transmission time estimate for the
  1527.           next received file.
  1528.  
  1529.  
  1530.           EXAMPLE: "speed 19200; estimate 0 2400" Use an effective
  1531.           transmission speed of 2400 for transmission time estimates instead
  1532.           of the 19200 bps interface speed.
  1533.  
  1534.  
  1535.         EXPand sourcefile pathspec ** For each pathname in pathspec, execute
  1536.           the commands in sourcefile with the string parameter item set to the
  1537.           current pathname.  The commands in sourcefile must not themselves
  1538.           contain wildcards (* or ?) or directory pathnames.  If no files
  1539.           match pathspec, sourcefile is not executed.  If the script executed
  1540.           has a READ ONLY attribute, ZCOMM is unrestricted during execution of
  1541.           the script.
  1542.  
  1543.           EXAMPLE: expand plxupl 001* Executes the script plxupl once for each
  1544.           file matching the wild card specification 001*.
  1545.  
  1546.  
  1547.           EXAMPLE: expand a *.arc where the file a contains:
  1548.                           obey "!pkxarc -v %item >> arclist"
  1549.           lists the contents of all .arc files to arclist.
  1550.  
  1551.  
  1552.           Chapter 99 explains the use of this command in more detail.
  1553.  
  1554.         f [-modes] file The f (think of "file") command initiates transmission
  1555.           of file with the term function.  One or more term function modes
  1556.           (described in Chapter 18) may be enabled with the optional modes
  1557.  
  1558.  
  1559.         (C) 1988 Omen Tech Inc                        Chapter 17 Main Commands
  1560.  
  1561.  
  1562.         Version 17.32 TurboDial 2.33            Universal Line Printer Edition
  1563.         ZCOMM User Manual                                                   87
  1564.  
  1565.  
  1566.           flag.
  1567.  
  1568.           If q (TWX) mode is enabled, transmission pauses until the called
  1569.           system's answerback restarts it with an XON, or until g mode is set.
  1570.           Otherwise, any XOFF induced transmission pause is reset.
  1571.  
  1572.           Once the file has been opened with the f command, X mode or
  1573.           keyboarding F1 or ALT-X will exit the term function with file
  1574.           incompletely transmitted.  The rest of the file may be transmitted
  1575.           by the t, F2, or wait commands.
  1576.  
  1577.           EXAMPLE: f -px message Uploads message paced by the p mode, which
  1578.           sends a carriage return and pauses at the end of each transmitted
  1579.           line until the remote responds with the prompt character (default
  1580.           line feed).  The x mode makes the term function return to the script
  1581.           after the file has been transmitted.
  1582.  
  1583.  
  1584.           EXAMPLE: set eolstr "\r."; pp1000; pg58; f -p file Is useful for
  1585.           uploading a prepared message to a CompuServe bulletin boards using
  1586.           the "SIG" editor (not FILGE).  The eolstr setting inserts a period
  1587.           after each line to prevent the CompuServe software from reformatting
  1588.           the message.  Pp10000 Sets the pause timeout to a long time.  Pg58
  1589.           Sets the prompt character to ":".  f -p file Transmits the file.
  1590.  
  1591.  
  1592.           SEE ALSO: b, g, p, r, n, t, w, x, X modes, eolstr string parameter,
  1593.           t and wait commands
  1594.  
  1595.         fail Terminate the current expand command, otherwise return from the
  1596.           current script level with failure status.
  1597.  
  1598.           If called directly by another level of script, that level is
  1599.           terminated.
  1600.  
  1601.           The fail command also causes the term function to exit, to allow a
  1602.           function key to be programmed with a macro that exits the term
  1603.           function.
  1604.  
  1605.           If called implicitly by a number presented for dialing, fail
  1606.           terminates the current dialing attempt.  If no retries are left, the
  1607.           call is abandoned.
  1608.  
  1609.         fg Indicates ZCOMM is running in the foreground with a user at the
  1610.           keyboard.
  1611.  
  1612.           SEE ALSO: bg command, df test condition
  1613.  
  1614.         fget outfile * Gets 8 bit raw data from the modem to outfile without
  1615.           any protocol.  No data is displayed on the screen.  Keyboarding F1
  1616.           terminates recording; any other keyboarded character is sent to the
  1617.  
  1618.  
  1619.         (C) 1988 Omen Tech Inc                        Chapter 17 Main Commands
  1620.  
  1621.  
  1622.         Version 17.32 TurboDial 2.33            Universal Line Printer Edition
  1623.         ZCOMM User Manual                                                   88
  1624.  
  1625.  
  1626.           remote.  Iff the g numeric parameter is set to to some value other
  1627.           than its default of 10 (line feed), the fget command terminates upon
  1628.           reading and storing a character matching the g numeric parameter.
  1629.           The fget command also terminates recording on loss of carrier detect
  1630.           signal.
  1631.  
  1632.           This command can be used when the flow of data from the remote
  1633.           cannot be regulated.  The maximum rate attainable without loss of
  1634.           data is limited by the maximum interrupt latency of the operating
  1635.           system and active device drivers.  The time required to write a 512
  1636.           character buffer to disk may also limit the maximum average data
  1637.           rate.  Each 512 character block must be written before the modem
  1638.           interrupt input buffer overflows with new data.  If the startup time
  1639.           for a floppy disk is excessive, better results will be obtained
  1640.           writing to a hard disk or ramdisk[8] if a suitable device is
  1641.           available.  Tests with an IBM Personal Computer, DOS 2.1, and a
  1642.           Maynard Electronics hard disk suggest that no characters are lost at
  1643.           9600 baud.  (Your results will vary depending on your configuration
  1644.           and programming habits.  California estimates lower.)
  1645.  
  1646.           EXAMPLE: fget rawdata
  1647.  
  1648.  
  1649.         find string pathspec Find and display lines containing matches to
  1650.           string in the specified files.  Lower case characters in string
  1651.           match either case; upper case characters in string match upper case
  1652.           characters only.  If string contains spaces, tabs, or semicolon, it
  1653.           must be enclosed by double quote characters.  ZCOMM C style escapes
  1654.           may be used to represent control characters and string parameters to
  1655.           be searched for.  Assuming normal DOS files (with CR/LF at the end
  1656.           of each line), a \n at the beginning of string forces a match to the
  1657.           beginning of a line.  A \r at the end of string (\n if the file(s)
  1658.           have no returns in them) forces a match at the end of the line.
  1659.  
  1660.           The file name being searched and its length are displayed in the
  1661.           status line.  For each line that contains a match to string, the
  1662.           file name (if more than one file), line number, and the text of the
  1663.           line are displayed.
  1664.  
  1665.           EXAMPLE: find count *.c Finds all occurrences of count or COUNT in
  1666.           the named files.
  1667.  
  1668.  
  1669.           SEE ALSO: egrep command
  1670.  
  1671.  
  1672.  
  1673.         __________
  1674.  
  1675.          8. See comments on Extended Memory ramdisks in Chapter 26.
  1676.  
  1677.  
  1678.  
  1679.         (C) 1988 Omen Tech Inc                        Chapter 17 Main Commands
  1680.  
  1681.  
  1682.         Version 17.32 TurboDial 2.33            Universal Line Printer Edition
  1683.         ZCOMM User Manual                                                   89
  1684.  
  1685.  
  1686.         FINDMore string pathspec Findmore finds a line matching string in each
  1687.           of the specified files, and then pages through the file beginning
  1688.           with the matched line.  Otherwise, it is similar to the find
  1689.           command.  When the screen is filled up, the prompt More?  appears.
  1690.           Typing space displays another screenfull.  Typing n skips to the
  1691.           next instance of string that has not yet been displayed.  Typing ^Q
  1692.           or ^S displays one more character from the file.  Typing ^X skips to
  1693.           the next file.
  1694.  
  1695.           SEE ALSO: egrepm, page commands
  1696.  
  1697.         findq string pathspec Silently searches the specified files for the
  1698.           first line matching string.  The processing of string is identical
  1699.           to the find command described above.  Upon a successful search, the
  1700.           contents of this line are stored in the z0 string variable and the ?
  1701.           numeric parameter is incremented.  The findq command is useful for
  1702.           fetching password information from a disk file.
  1703.  
  1704.           SEE ALSO: egrepq command
  1705.  
  1706.         finish Terminates Kermit server operation on the remote system.
  1707.  
  1708.         fput file * Puts data from file to the remote at maximum speed without
  1709.           any protocol.  After each 512 characters, the number of characters
  1710.           transmitted is displayed in the status line, and the keyboard is
  1711.           polled.  Any key will abort the transfer.  This is the fastest way
  1712.           ZCOMM can transmit characters to the modem, with possible peak
  1713.           speeds greater than 19kb.  This command is useful for testing RS232
  1714.           peripherals at high peak rates such as 56 kilobaud.
  1715.  
  1716.           EXAMPLE: fput datafile
  1717.  
  1718.  
  1719.         fpute file * Echoplex transmit a file to the remote, waiting for the
  1720.           correct echo to each character transmitted (for Throttle/10
  1721.           seconds).  The echoed character is sent to the CRT screen.  If fpute
  1722.           receives a space as an echo to a tab, fpute waits for the spaces to
  1723.           stop echoing for at least 100 milliseconds before resuming
  1724.           transmission.  Transfer speed thus suffers when tabs are present in
  1725.           the transmitted file unless the remote can be set to echo tabs as
  1726.           tab characters instead of expanding them to spaces.  Throughput is
  1727.           less than 1/3 of normal because of the echo delay.
  1728.  
  1729.           Fpute counts each time the correct character is not echoed as an
  1730.           error.
  1731.  
  1732.           With n mode, fpute transmits only a linefeed at the end of each
  1733.           line.  With r mode, fpute transmits only a carriage return at the
  1734.           end of each line.  Most applications would use one of these modes.
  1735.  
  1736.           CPMEOF (Ctrl-Z) terminates the file transmission unless b mode is
  1737.  
  1738.  
  1739.         (C) 1988 Omen Tech Inc                        Chapter 17 Main Commands
  1740.  
  1741.  
  1742.         Version 17.32 TurboDial 2.33            Universal Line Printer Edition
  1743.         ZCOMM User Manual                                                   90
  1744.  
  1745.  
  1746.           set.
  1747.  
  1748.           Because fpute waits for the correct echo to each character sent,
  1749.           fpute should be used for transmitting characters to programs that
  1750.           echo exactly.
  1751.  
  1752.           Often it is easy to write a simple receive routine to synchronize
  1753.           with the sender by echoing each character received.  On some
  1754.           microcomputer systems, the device "TTY:" does just that.  Fpute is
  1755.           especially useful for "spoon feeding" files to the serial inputs of
  1756.           microcomputers and minicomputers.
  1757.  
  1758.           SEE ALSO: f command
  1759.  
  1760.         get filespec Instructs a remote Kermit server to the transmit the
  1761.           specified file(s), then receives them.  The form of filespec varies
  1762.           with the remote system; it must be quoted if it contains any special
  1763.           characters or spaces.  The get command only operates with a Kermit
  1764.           server; use kermit rb to receive files from a regular Kermit
  1765.           program.
  1766.  
  1767.         goback label Search the current script file for label: and execute
  1768.           commands starting at that line.  The goback command begins the
  1769.           search at the beginning of the file.  It is faster than the goto
  1770.           command which begins the search at the current line.
  1771.  
  1772.           SEE ALSO: goto command
  1773.  
  1774.         gosub name[.path] Call a script as a subroutine.  The phone directory
  1775.           is searched for name unless another file is specified with .path.
  1776.           Gosub has the same action as the call command (q.v.), but does not
  1777.           reset modes, disconnect the modem, or modify the remote parameter.
  1778.  
  1779.           EXAMPLE: gosub dosig Executes the dosig entry in the telephone
  1780.           directory.
  1781.  
  1782.  
  1783.           EXAMPLE: gosub .%lib/baud.t Executes the commands in c:/yam/baud.t
  1784.           assuming the lib string parameter contains c:/yam.
  1785.  
  1786.  
  1787.           SEE ALSO: call command
  1788.  
  1789.         goto label Search the current script file for label: and execute
  1790.           commands starting at that line.  A label is a line with the label
  1791.           starting in the first column followed by a colon.  Iff label
  1792.           precedes the current script line, the goback command will locate the
  1793.           target label more quickly.  The goto command is valid only within a
  1794.           script or telephone directory entry.  Please refer to Chapter 99 for
  1795.           examples using the pattern, if, goto, and source commands.
  1796.  
  1797.  
  1798.  
  1799.         (C) 1988 Omen Tech Inc                        Chapter 17 Main Commands
  1800.  
  1801.